<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Official Perl 6 Documentation</title>
<link rel="stylesheet" href="http://dev.perl.org/css/perl.css" type="text/css" />
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:" />
</head>

<body style="margin-left: 0.3in">

<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>
<td align="right">
<form method="get" action="http://www.google.com/search" style="position: absolu te; top: 5px; right: 5px; text-align: right; "><div>
<input type="hidden" name="ie" value="UTF-8" />
<input type="hidden" name="oe" value="UTF-8" />
<input type="hidden" name="domains" value="feather.perl6.nl" />
<input type="hidden" name="sitesearch" value="feather.perl6.nl/syn/" />
<input type="text" name="q" size="31" maxlength="255" value="" /> 
<input type="submit" name="btnG" value="Google Search the Synopses" />
</div></form>
</td>
</tr>
</table>


<h2><a name="Feather">Official Perl 6 Documentation</a></h2>

<p>The Synopsis documents are to be taken as the formal 
specification for Perl 6 implementations, while still 
being reference documentation for Perl 6, like 
<i>Programming Perl</i> is for Perl 5. Note that while 
these documents are considered ``formal
specifications'', they are still being subjected to the
rigours of cross-examination through implementation.
In other words, they may change slightly or radically. 
But the expectation is that they are ``very close'' to 
the final shape of Perl 6. </p>

<p>However, this HTML version of Synopses is slightly
different in that it contains code snippets from
the Pugs test suite. In other words, We have divided the .t files in the Pugs
test suite into pieces and inserted every resulting 
snippet after the corresponding paragraph of the Synopses.
The job was done by the Perl 5 script util/smartlinks.pl
living in the Pugs source tree. And all the web pages listed
below are updated every <i>one</i> hour with the latest Synopses
and Pugs test suite from their respective SVN repositories.  </p>

<p>When we say ``S05'', we mean ``spec'' as well as ``synopsis''.</p>

<p><em>While the Apocalypses and Exegeses are linked here for reference, note
that the Synopses are kept very much more up-to-date and are the primary recommended reference.</em></p>

<table>
    <tr>
        <th></th>
        <th></th>
        <th><strong>(Specification)</strong>
		&nbsp; &nbsp; &nbsp; &nbsp;</th>
        <th>(Justification)</th>
        <th>(Explanation)</th>
    </tr>
    <tr>
        <td>1</td>
        <td>Overview</td>
        <td><a href="S01.html"><strong>Synopsis</strong></a></td>
        <td><a href="http://dev.perl.org/perl6/doc/design/apo/A01.html">Apocalypse</a></td>
    </tr>
    <tr>
        <td>2</td>
        <td>Bits and Pieces</td>
        <td><a href="S02.html"><strong>Synopsis</strong></a></td>
        <td><a href="http://dev.perl.org/perl6/doc/design/apo/A02.html">Apocalypse</a></td>
        <td><a href="http://dev.perl.org/perl6/doc/design/exe/E02.html">Exegesis</a></td>
    </tr>
    <tr>
        <td>3</td>
        <td>Summary of Perl 6 Operators &nbsp; &nbsp; &nbsp; &nbsp;</td>
        <td><a href="S03.html"><strong>Synopsis</strong></a></td>
        <td><a href="http://dev.perl.org/perl6/doc/design/apo/A03.html">Apocalypse</a></td>
        <td><a href="http://dev.perl.org/perl6/doc/design/exe/E03.html">Exegesis</a></td>
    </tr>
    <tr>
        <td>4</td>
        <td>Blocks and Statements</td>
        <td><a href="S04.html"><strong>Synopsis</strong></a></td>
        <td><a href="http://dev.perl.org/perl6/doc/design/apo/A04.html">Apocalypse</a></td>
        <td><a href="http://dev.perl.org/perl6/doc/design/exe/E04.html">Exegesis</a></td>
    </tr>
    <tr>
        <td>5</td>
        <td>Regexes and Rules</td>
        <td><a href="S05.html"><strong>Synopsis</strong></a></td>
        <td><a href="http://dev.perl.org/perl6/doc/design/apo/A05.html">Apocalypse</a></td>
        <td><a href="http://dev.perl.org/perl6/doc/design/exe/E05.html">Exegesis</a></td>
    </tr>
    <tr>
        <td>6</td>
        <td>Subroutines</td>
        <td><a href="S06.html"><strong>Synopsis</strong></a></td>
        <td><a href="http://dev.perl.org/perl6/doc/design/apo/A06.html">Apocalypse</a></td>
        <td><a href="http://dev.perl.org/perl6/doc/design/exe/E06.html">Exegesis</a></td>
    </tr>
    <tr>
        <td>7</td>
        <td>Formats</td>
        <td></td>
        <td><a href="http://dev.perl.org/perl6/doc/design/apo/A07.html">Apocalypse</a></td>
        <td><a href="http://dev.perl.org/perl6/doc/design/exe/E07.html">Exegesis</a></td>
    </tr>
    <tr>
        <td>9</td>
        <td>Data Structures</td>
        <td><a href="S09.html"><strong>Synopsis</strong></a></td>
        <td></td>
        <td></td>
    </tr>
    <tr>
        <td>10</td>
        <td>Packages</td>
        <td><a href="S10.html"><strong>Synopsis</strong></a></td>
        <td></td>
        <td></td>
    </tr>
    <tr>
        <td>11</td>
        <td>Modules</td>
        <td><a href="S11.html"><strong>Synopsis</strong></a></td>
        <td></td>
        <td></td>
    </tr>
    <tr>
        <td>12</td>
        <td>Objects</td>
        <td><a href="S12.html"><strong>Synopsis</strong></a></td>
        <td><a href="http://dev.perl.org/perl6/doc/design/apo/A12.html">Apocalypse</a></td>
        <td></td>
    </tr>
    <tr>
        <td>13</td>
        <td>Overloading</td>
        <td><a href="S13.html"><strong>Synopsis</strong></a></td>
        <td></td>
        <td></td>
    </tr>
    <tr>
        <td>16</td>
        <td>IPC / IO / Signals [DRAFT] </td>
        <td colspan="3"><a href="S16.html"><strong>Synopsis</strong></a>
            <!-- Agentz: Please add Documentation.pod to the HTMLization system. Thanks! -->
        </td>
    </tr>
    <tr>
        <td>26</td>
        <td>Documentation [DRAFT]</td>
        <td colspan="3"><a href="S26.html"><strong>Synopsis</strong></a>
            <em>(link may not be active yet) </em>
            <!-- Agentz: Please add Documentation.pod to the HTMLization system. Thanks! -->
        </td>
    </tr>
    <tr>
        <td>29</td>
        <td>Builtin Functions</td>
        <td><a href="S29.html"><strong>Synopsis</strong></a></td>
        <td></td>
        <td></td>
    </tr>
</table>

<h2>DRAFT specifications</h2>
<p>
The few draft PODs here should probably be cleaned up into Spec-like
formats and moved to Perl6::Spec space.
</p>
<ul>
 <li><a href="http://svn.openfoundry.org/pugs/docs/AES/A20draft.pod">Debugging</a></li>
 <li><a href="http://svn.openfoundry.org/pugs/docs/AES/S27draft.pod">Perl Culture</a></li>
 <li><a href="http://svn.openfoundry.org/pugs/docs/AES/S28draft.pod">Special Variables</a></li>
</ul>

<h2>Frequently Asked Questions</h2>

<!-- please convert these to HTML and link to those versions -->
<ul>
    <li><a href="http://dev.perl.org/perl6/faq.html">General Questions about Perl6</a></li>
    <li><a href="http://svn.openfoundry.org/pugs/docs/01Overview.html">Pugs FAQ</a></li>
    <li><a href="http://svn.openfoundry.org/pugs/docs/Perl6/FAQ/FUD.pod">Fears, Uncertainties and Doubts about Perl6</a></li>
    <li><a href="http://svn.openfoundry.org/pugs/docs/Perl6/FAQ/Capture.pod">Capture Objects</a></li>
</ul>

<h2>Differences from Perl 6</h2>

<ul>
    <li><a href="Differences.html">Differences Between Perl 5 and Perl 6</a></li>
</ul>

<p>
The Differences document is stored in <code>docs/Perl6/Perl5/Differences.pod</code>
in the pugs repository, if you'd like to make updates to it. Your changes will 
automatically appear on feather in less than 1 hour.
</p>

<h2>Perl6 Cookbooks</h2>

<ul>
    <li><a href="http://svn.openfoundry.org/pugs/examples/cookbook/">Perl6 Cookbook</a> 
    Currently a work in progress, this cookbook is part of the 
            <a href="http://pleac.sourceforge.net/">PLEAC</a> project,
    following the example of the Perl 5 cookbook.
    
    </li>
    <li><a href="http://cog.cognitivity.com/perl6/">Perl6 OO Cookbook</a> <em>(parts may not be current)</em></li>
</ul>

<h2>Example Code</h2>
<p>
Many more examples of Perl6 code are available.
</p>
<ul>
    <li><a href="http://svn.openfoundry.org/pugs/examples/">Examples of Perl6 from the Pugs repository</a></li>
    <li><a href="http://svn.openfoundry.org/pugs/ext/">Complete distributions from the Pugs repository</a></li>
</ul>





<h2>About this page</h2>

<p>
The page you're currently looking at lives in the Pugs repo as 
<code>docs/feather/syn_index.html</code>, and is resync'd every few minutes.
</p>

</body>

</html>
